-----------------------------------------
       Realistic Holster v3.4
-----------------------------------------
🎉 Thanks for installing Realistic Holster! 🎉
Follow this guide to get the plugin running smoothly.
-----------------------------------------
📌 Requirements
-----------------------------------------
Before installing, make sure you have the following:
- LSPDFR (Latest version)
- RagePluginHook (v1.124+ recommended)
- EUP Law & Order
- RageNativeUI

> Make sure all are installed and working before using this plugin.
-----------------------------------------
⚡ Installation
-----------------------------------------
1. Place the plugin DLL and .ini in:
   Grand Theft Auto V/Plugins/LSPDFR/
2. Place the sound folder (RealisticHolster) in:
   Grand Theft Auto V/Plugins/LSPDFR/
3. DO NOT place the DLL anywhere else.
4. Launch GTA V via RagePluginHook to load the plugin.

Required sound files (must be .wav format):
- Holster.wav        → plays when gun is holstered
- Unholster.wav      → plays when gun is drawn
- TaserHolster.wav   → plays when taser is holstered
- TaserUnholster.wav → plays when taser is drawn

> If your sounds are MP3, convert them to WAV first (cloudconvert.com is free).
-----------------------------------------
🛠 Configuration
-----------------------------------------
Open the menu in-game with F2 (configurable in the INI).

Menu Structure:
- Gun Holster Presets      → Select from built-in gun holster styles
- Taser Belt Presets       → Select from built-in taser belt styles
- Custom Holsters          → Set your own custom EUP drawables
- Custom Pistol Holsters   → 3 slots for custom gun holsters
- Custom Taser Belts       → 3 slots for custom taser belts
- Custom Taser Vest        → 2 slots for custom taser Vests
- Custom Pistol Vest       → 2 slots for custom Pistol Vests
- Addon Weapons & Tasers   → Register addon weapon/taser hashes
- Blacklisted Weapons      → Stop specific weapons from triggering holster swaps
- Settings                 → Toggle all features on/off
- Export Preset Code       → Save your holster setup to a shareable file
- Import Preset Code       → Load a holster setup from a file
- Save All Settings        → Save everything to INI

Built-in Gun Holster Presets:
- Cop Holster
- Leather Holster
- Leg Holster
- Dropped Holster
- Chest Holster

Built-in Taser Belt Presets:
- Green Taser Belt
- Yellow Taser Belt
- Yellow Taser Belt 2

Settings Menu Options:
- Gun Holster Swapping
- Taser Belt Swapping
- Allow Swapping In Vehicles
- Gun Draw / Holster Sounds
- Taser Draw / Holster Sounds
- Draw Animation (overrides LSPDFR unholster only)
- AI Holster Sync (Ultimate Backup / Policing Redefined)
- AI Holster Sounds (within radius)
- AI Sound Radius (default: 5m)
- Unknown Weapon Detection
- Unknown Weapon Notifications
- Show Startup Message
- Show General Notifications
- Intimidation Key (default: K)
-----------------------------------------
🔫 Custom Holsters
-----------------------------------------
Custom holsters require EUP components that have 2 versions:
- One WITH the gun/taser visible (holstered state)
- One WITHOUT the gun/taser (unholstered/drawn state)

To set a custom holster, enter values in this format:
   HolsteredDrawable, HolsteredTexture, UnholsteredDrawable, UnholsteredTexture
   Example: 9,1,3,1

> Values are entered as what you see in-game (the plugin handles offsets automatically).
> If you have no custom EUP holsters, there is no need to use this section.
-----------------------------------------
🔫 Addon Weapons & Tasers
-----------------------------------------
If you use addon pistols or tasers that are not vanilla GTA V weapons:
1. Equip the addon weapon in-game
2. Open the menu → Addon Weapons and Tasers
3. Press "Detect Equipped Weapon Hash"
4. Press "Save as Pistol" or "Save as Taser"
5. Press "Save All" to keep it permanently

> An on-screen warning will appear the first time an unknown weapon is detected.
> This can be disabled in Settings.
-----------------------------------------
🚫 Blacklisted Weapons
-----------------------------------------
Use this to stop specific weapons from triggering any holster swaps.
This is useful for prop weapons, lidar guns, or any item that shares
a hash with a pistol but should not affect your holster.

To blacklist a weapon:
1. Equip the weapon in-game
2. Open the menu → Blacklisted Weapons
3. Activate any empty slot to save its hash
4. Press "Save All" to keep it permanently

To remove a blacklisted weapon:
- Open the menu → Blacklisted Weapons
- Press "Clear Slot X" on the slot you want to remove

> Blacklisted weapons are completely ignored by the holster system.
> No EUP swap, no animation, no sound will trigger for them.
-----------------------------------------
🤖 AI Holster Sync
-----------------------------------------
When enabled, nearby AI officers (spawned by Ultimate Backup or
Policing Redefined) will have their EUP holster components swapped
automatically when they draw or holster their weapon.

Requirements:
- AI officers must be wearing EUP outfits with matching holster drawables
- The plugin matches their holster drawable against your configured presets
- No extra setup needed beyond enabling the toggle in Settings

Settings:
- AI Holster Sync        → Enable/disable AI holster swapping entirely
- AI Holster Sounds      → Play draw/holster sounds when nearby AI officers
                           draw or reholster (within the sound radius)
- AI Sound Radius        → How close an AI officer must be for sounds to play
                           Default is 5 metres, configurable in Settings

> AI holster swapping is silent (no animations) and performance-friendly.
> Only checks peds within 20 metres every 10 frames.
-----------------------------------------
📤 Export / Import Preset Codes
-----------------------------------------
You can share your full holster setup with other players using preset codes.

To export:
1. Open the menu → Export Preset Code
2. Your setup is saved to:
   Plugins/LSPDFR/RealisticHolster/PresetCode.txt

To import:
1. Place the PresetCode.txt file in:
   Plugins/LSPDFR/RealisticHolster/
2. Open the menu → Import Preset Code
3. All drawables are applied instantly and saved to INI
4. Restart LSPDFR for all changes to take full effect

> The preset code includes your active gun/taser holster drawables
> and all 3 custom gun/taser slots.
> Settings toggles and blacklisted hashes are NOT included in the preset.
-----------------------------------------
🕺 Intimidation Stance
-----------------------------------------
Press K (default) to play the hand-on-holster intimidation animation.
Press K again to cancel it.

- Cannot be activated while a weapon is drawn
- Automatically cancelled when you draw your weapon
- Key can be changed in Settings menu or directly in the INI
-----------------------------------------
🎬 Draw Animation
-----------------------------------------
When enabled, a draw animation plays when you unholster your gun.
The EUP component swaps instantly — the animation is purely cosmetic.

- Works while the player is walking or running
- Overrides the LSPDFR unholster animation only
- Can be toggled in Settings

> If disabled, both LSPDFR draw and holster animations work normally.
-----------------------------------------
💾 INI File
-----------------------------------------
Located at: Plugins/LSPDFR/RealisticHolster.ini
Only edit manually to change keys.
All other settings are saved via the in-game menu → Save All Settings.
-----------------------------------------
💬 Support
-----------------------------------------
- Any issues or questions? Contact aaron.txt on Discord.
- Have fun and happy policing! 🚔
-----------------------------------------
   What's New in v3.4:

- Blacklisted Weapons submenu (3 slots)
- AI holster syncing for Ultimate Backup / Policing Redefined
- AI holster sounds within configurable radius
- Export / Import preset codes via PresetCode.txt
- Cleaned up the menu
-----------------------------------------
       By Angel AI | Release 3.4
-----------------------------------------
